--- d:\node.module	Mon Dec 11 17:42:42 2006
+++ d:\node.module.new	Wed Dec 13 06:47:44 2006
@@ -15,16 +15,25 @@ define('NODE_NEW_LIMIT', time() - 30 * 2
 function node_help($section) {
   switch ($section) {
     case 'admin/help#node':
-      $output = '<p>'. t('All content in a website is stored and treated as <b>nodes</b>. Therefore nodes are any postings such as blogs, stories, polls and forums. The node module manages these content types and is one of the strengths of Drupal over other content management systems.') .'</p>';
-      $output .= '<p>'. t('Treating all content as nodes allows the flexibility of creating new types of content. It also allows you to painlessly apply new features or changes to all content. Comments are not stored as nodes but are always associated with a node.') .'</p>';
-      $output .= t('<p>Node module features</p>
+  $output = '<p>'. t('All content on a Drupal website is stored and treated as "nodes." A node is any posting, such as a page, poll, story, forum text, or blog entry. Comments are not stored as nodes but are always tied to one.') .'</p>';
+     $output .= '<p>'. t('Behind the scenes, the nodes module manages these nodes. This module is what lets you</p>
 <ul>
-<li>The list tab provides an interface to search and sort all content on your site.</li>
-<li>The configure settings tab has basic settings for content on your site.</li>
-<li>The configure content types tab lists all content types for your site and lets you configure their default workflow.</li>
-<li>The search tab lets you search all content on your site</li>
+  <li>	list, sort through, and manage all the content on your site (on the <a href="@admin-posts">posts</a> page) </li>
+  <li>	set norms for how posts are entered and displayed (on the <a href="@post-settings">post settings</a> page)</li>
+  <li>	search all the content on your site (with the <a href="@search-posts">search posts</a> page) 
+<strong>[MY COMMENT: Isn&#8217;t the Search Posts Page provided by the Search module?
+If so, this line doesn&#8217;t belong here.]</strong></li>
+  <li> list and configure the "content types" for your site and create new ones (on the <a href="@admin-types">content types</a> page) </li>
 </ul>
 ');
+     $output .= '<p>'. t('Offering "content types" is a way Drupal allows you to have different kinds of nodes for different purposes. For example, a "story" is one kind of node, a "book page" another, and a "blog entry" yet another. You can also create new content types of your own.', array('admin-types' => url('admin/content/types'))) .'</p>';
+     $output .= '<p>'. t('On the <a href="@admin-types">content types</a> page you can <em>edit</em> a content type to change some of its features. Suppose you&#8217;ve created a content type called "new products." You can have your "create content" page tell your users what kind of products you want them to announce. Your submission form might ask for a <em>title</em> by saying "Tell me the name of the product." And for the <em>body</em> it might ask, "Tell me what this product will do for me." You can also specify various workflow options.', array('@admin-types' => url('admin/content/types'))).'</p>';
+     $output .= '<p>'. t('When you want to manage posts, on your <a href="@admin-posts">posts</a> page you&#8217;ll have the option to list only the posts for a particular content type. On your <a href="@admin-theme">themes</a> page you can decide, for each content type, whether or not each post will display the text "submitted by Username on date." And <a href="@search">advanced search</a> allows your users to choose the content types within which to conduct a search.', array('@admin-theme' => url('admin/build/themes'), '@admin-posts' => url('admin/content/node'), '@search' => url('search/node'))) .'</p>';
+     $output .= '<p>'. t('Beyond this, other Drupal modules can focus on a content type and do much more with it. For example, you might look at what Drupal&#8217;s built-in modules do with the content types "book," "poll," or "forum." <em>Contributed modules</em> offer you still further possibilities.') .'</p>';
+     $output .= '<p>'. t('The nodes module also provides a <em>revisions</em> feature, which lets users to whom you give permission create multiple revised versions of posts and revert to a previous version when desired. Such users will see "Create new version" among the <em>Publishing options</em> when they edit a post. And when viewing posts that have revised versions these users will see a <em>Revisions</em> tab, where they can track and manage the various versions.') .'</p>';
+     $output .= '<p>'. t('On your <a href="@admin-permissions">permissions</a> page you can decide who can access content, who can administer nodes, who can create and revert revisions, and who can administer content types. And for each content type, you can decide who can create posts and who can edit them.', array('@admin-permissions' => url('admin/user/access'))) .'</p>';
+     $output .= '<p>'. t('The nodes module also lets you easily apply new features or changes to all the content on your site. 
+<strong>[MY COMMENT: Great, but how? Without further explanation, this sentence is more tantalizing than helpful. Either we should tell how to do it or delete the line.]</strong>') .'</p>';
       $output .= '<p>'. t('For more information please read the configuration and customization handbook <a href="@node">Node page</a>.', array('@node' => 'http://drupal.org/handbook/modules/node/')) .'</p>';
       return $output;
     case 'admin/content/search':